Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Setting Up Transformation Matrices

Q3Matrix4x4_SetRotateAboutAxis

You can use the Q3Matrix4x4_SetRotateAboutAxis function to configure a 4-by-4 rotate-about-axis transformation matrix.

TQ3Matrix4x4 *Q3Matrix4x4_SetRotateAboutAxis (
TQ3Matrix4x4 *matrix4x4, 
const TQ3Point3D *origin, 
const TQ3Vector3D *orientation, 
float angle);

matrix4x4

A 4-by-4 matrix.

origin

The desired origin of rotation.

orientation

The desired orientation of the axis of rotation.

angle

The desired angle of rotation, in radians.

DESCRIPTION

The Q3Matrix4x4_SetRotateAboutAxis function returns, as its function result and in the matrix4x4 parameter, an rotate-about-axis matrix that rotates an object by the angle angle around the axis determined by the point origin and the orientation orientation.